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Based on iButton ™ ICs 


Design by P Gros 





In this day and age it is trendy to put the letter e (for ‘electronic’) in front 
of many words, names and concepts, for example, e-business, e-life etc. 
We jump the bandwagon and describe e-Key, a controlled-access system 
based on iButton integrated circuits from Dallas Semiconductor. 





The circuit described in this article allows a_Kay M a i m Easatiirac 
two relays to be controlled with the aid of SM NSY TIGIN Fate. 
electronic keys. These keys are based on 


components manufactured by Dallas Semi- — Max. number of keys recognized: ib 

conductors, and go by the name ‘iButton’. — Outputs: 2 
Designed in the first place to switch alarm — Max. distance between circuit and key reader: I5 m 

systems on and off, the ‘iButton’ component — CRC on codes read from keys 

can have many other applications like con- — System Watchdog 

trolled access to a PC, electronic door open- — Power supply: 7-15 Vdc 

ots, Ete. — Current consumption: max. 50 mA depending on relay state 


This type of lock with electronic key con- 
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trol has many advantages over tra- 
ditional systems. The electronic ver- 
sion consists of three components: 
user interface, processing unit and 
control interface. 

In order to afford maximum secu- 
rity, it is essential to physically sep- 
arate the user interface from the pro- 
cessing unit, because the latter is 
subject to sabotage, vandalism and, 
of course, malfunctions. Most key 
boxes and number-code boxes used 
with traditional controlled access 
systems contain the necessary elec- 
tronic parts as well as the relay, all 
in one and the same case. Once the 
case is vandalised, a simple short 
Circuit or the cutting of a few wires 
is enough to disable the alarm or 
security system. Moreover, the 
access code may be easy to find 
inside the case. 

The electronic key system 
described here allows the user inter- 
face to be removed a few metres 
from the control electronics (pro- 
cessing unit). The user interface con- 
sist of nothing but a two-way con- 
nector. The result is a higher degree 
of security. Even if the reader unit is 
torn apart, allowing a vandal to 
short-circuit the wires, the alarm 
system will remain armed. 


The key 


The ‘iButton’ component from Dallas 
Semiconductor looks like a button 
cell, having a diameter of about 
17 mm and a thickness of 3 to 5 mm. 

The 5-mm thick version of the 
‘Button’ may be secured in a special 
holder (designed by Dallas) to make 
a key which is not only easily han- 
dled on its own but also suitable for 
clipping on a key ring, alongside tra- 
ditional, mechanical keys (see the 
illustration at the start of this arti- 
cle). As illustrated in Figure 1, it may 
be even be secured to a watch. 

Two connections (including 
ground) give access to all function- 
ality crammed into the ‘iButton’. 

The ‘iButton’ family consists of a 
great many devices, of which a num- 
ber have been specially designed for 
use in controlled access systems. 
Within the family there are simple 
devices with an identifier of just 
6 bytes (48 bits), but also compo- 
nents with memory structures of 
which certain zones remain inacces- 
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sible until the correct password is 
supplied. 

Once the iButton is in contact 
with reader socket, it is powered 
and indicates its presence to a 
microcontroller which starts to 
exchange data and commands. 

The present e-Key project is based 
on the simplest device in the ‘iBut- 
ton’ family, the DS1990A. It contains: 


— A ‘family’ code, encoded in 1 byte; 

— A Unique identifier, encoded in 6 
bytes (48 bits); 

— Acheck byte (CRC). 


The iButton data 
exchange protocol 


The ‘iButton’ supplies its internal 
data when an electrical contact is 
established between it and a suit- 
able reader device. 

Once the iButton is connected up, 
it is powered by the reader circuit. In 
order to inform the system of its 
presence, the iButton pulls a system 
line to logic Low (see greyed-out 
line, Figure 2a). This event triggers 
the start of the internal initialisation 
of the device. When the initialisation 
is finished, the Low level is removed, 
allowing the internal pull-up resistor 
in the circuit to take over. Once the 
time slot tggry İs Over, it is possible 
to send a command code. You can 
see the time slot available for the 
device initialisation sequence in the 
diagram shown in Figure 2a. The 
sequence is preceded by a ‘Master 
Reset Pulse’ sent out by the reader 
to re-initialise the iButton. In our 
case, the connection of the iButton to 
the reader contacts corresponds 
with the slot ‘trop’, or ‘Master Rg 
Presence Pulse’. 


Principle of 
data transmission 


with the iButton 

The internal memory of the DS1990A 
iButton is accessed by means of a 
one-wire connection. The protocol 
defines the way in which data and 
commands are exchanged. There are 
three types of data exchange: writ- 
ing a logic High level (‘1’) (Fig- 
ure 2b); writing a logic Low (‘0’) 
(Figure 2c) and reading a data bit 
(Figure 2d). The protocol defines 








Figure |. Example of an iButton electronic key 
secured on a wristwatch strap. 
(photograph courtesy Dallas Semiconductor) 


time slots during which the relevant logic lev- 
els are maintained, to allow transmitted data 
to be correctly latched by the receiving 
device. 

At the end of the reset phase, the DS1990A 
goes into command-entry mode. Once a com- 
mand is received, the DS1990A returns data 
as appropriate for a particular command. 
Every data transmission is subject to a cyclic 
redundancy check (CRC) operation. The CRC 
is based on an 8-bit polynomial (X8 + X5 + 
X4 +1). 

The data exchange flowchart for the 
DS1990A is shown in Figure 3. 


Operation and use 


The microcontroller starts by loading (regis- 
tering) the identifier of one or more keys in its 
EEPROM area. Because the AT9081200 used 
here contains 64 bytes, we employ 7 areas of 
6 + 2 bytes. This enables the reader circuit to 
recognise up to 7 different keys. 
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For each of the 7 keys, 6 bytes are regis- 
tered containing the serial number plus 2 
bytes that serve to specify the ‘on’ time of 
each of the output relays. 

In this way it is possible to define different 
keys to activate the first relay, the second 
relay or both at the same time. The aim 
should be to have the system perform two or 
three different actions depending on the keys 
used. In an alarm system, that allows one key 
to be defined for the proprietor, and others for 
(trusted) neighbours, household staff, the 
cleaning lady, etc. The latter keys could, for 
example, disarm a section of the alarm sys- 
tem only. 

The eight remaining bytes allow us to 
store counters keeping track of, for example, 
the number of watchdog reset actions, or the 
CRC of the relevant EEPROM area. 

The system parameters may be loaded 
using an RS232 terminal or a PC running a 
communication program (HyperTerminal is 
adequate for the purpose). The commands 
you may use are listed in Table 1. 

Be sure to get the commands right as you 
type them (in upper case only) as the com- 
mand processor, due to it being run in con- 
fined ROM space, is not particularly intelli- 
gent. 

The first command to type could be D 
which allows you to check that the EEPROM 
areas do not contain code. 

Command S allows the system to ‘get 
acquainted’ with a new key. Type the com- 
mand followed by an number between 1 and 
7. Next, apply the key to the reader. Its inter- 
nal identifier will be saved at the specified 
location (1 - 7). 

By default, the two relays are energized for 
5 seconds. This may be modified to suit your 
requirements by means of command A. 

Command C may be used to clear the iden- 
tifier of a particular key stored at location ‘n’. 

The last command, Z, clears all EEPROM 
areas. 


It is normal for LED D2 to remain off initially. 
The EEPROM area being empty, the auto- 
CRC will produce an error. This is automati- 
cally corrected however by using command 
A, C, Sor Z. 


The circuit 


The circuit diagram of the e-Ķey Secure 
Access System is shown in Figure 4. As you 
can see, the reader unit consists of very few 
parts indeed. The circuit is built around an 
AT90S1200 microcontroller from Atmel 
clocked at 4 MHz. This relatively low speed 
is more than adequate for our application. 
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Figure 2. Timing diagrams. (a) Initialisation sequence; (b) writing a logic |; (c) read- 
ing a logic Q; (d) waiting for data to arrive. (source: Dallas Semiconductor) 


Table I. 
e-Key Commands and Actions 


Command Name Action 
AnXXYY Action n=key number, XX= relay-| action, 
YY= relay-2 action, 
XX=00 no action, increment every | s (approx.) 
Cn Clear Clear identifier of key ‘n’. 
D Dump Clear entire EEPROM area 
Sx Set key Acquire identifier of new key, store in EEPROM 
zone reserved for recognized keys. 
x is key number (I - 7). 
Default ‘on’ time for relays is 5 seconds (approx.). 
Z Zero System reset and clear all EEPROM data. 
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Figure 3. Flowchart showing command processing and dataflow. 


It may be useful at this point to 
briefly recap the main features of the 
AT9081200: 1,024 bytes of Flash pro- 
gram memory, 32 bytes of RAM orga- 
nized as 32 registers, 64 bytes of 


EEPROM, one interrupt input, 
input/output ports and a watchdog 
reset. 


Reading an iButton is carried out 
via port line PD2 which also acts as 
the interrupt request input. It is 
necessary to program a ‘1’ to acti- 
vate the internal 1-kQ pull-up to 
+5 V, and so provide a ‘phantom’ 
power supply for iButtons when in 
contact with the reader. A close 
look at the timing diagram reveals 
that the iButton key, once powered, 
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forces a logic Low of about 470 Ls. 
This change in the logic level on 
PD2 triggers an interrupt request 
which, in turn, launches the ‘read’ 
procedure. 

A (TTL-level) RS232 serial inter- 
face is implemented using port lines 
PDO and PD1. PDO transmits the 
data (9,600 bits/s, no parity, 1 stop 
bit) with resistor R1 protecting the 
interfaces by limiting the current to 
a safe value. Port line PD1 is used as 
the receive line for data converted to 
TTL level by R2, R5 and T1. Resistor 
R3 in combination with diode D3 
allows an interrupt request to be 
generated when characters arrive on 
the serial input line. The interrupt 


handler determines the source of the request 
(PD1 or PD2). 

The communication with the circuit by way 
of the RS232 interface allows the following: 


— registering of new keys; 

— disabling of keys; 

— visualisation of identifiers read from recog- 
nized keys; 

— displaying of the code read from the key on 
every key ‘insertion’. If the CRC is wrong, a 
hash character (#) is displayed. 


A command is available to specify the ‘on’ 
time of the relays for each key. 

Port PB2 allows a LED to be controlled, in 
this case D2, which should light when the cir- 
cuit is working properly, that is, after com- 
pleting the initialisation procedure, and a cor- 
rect result for the CRC on the EEPROM. 

Ports PBO and PB1 control output relays 2 
and 1 respectively. Each of these has an indi- 
cator LED, D4 and D5 respectively. 

The power supply is based on the avail- 
ability of a dc source capable of supplying 7 
to 15 V at the required current. Diode D1 acts 
as a polarity reversal protection and a three- 
pin voltage regulator, IC1, steps down the 
input voltage to +5 V for the circuit to oper- 
ate from. 

The microcontroller’s RESET input does 
not have to be connected because the power- 
on reset circuitry is available inside the case. 





Construction 


Thanks to the availability of a ready-made 
printed circuit board whose design is shown 
in Figure 5, building the e-Key project should 
not pose practical problems. As usual, you 
start with the wire links, in this case, there’s 
just one, you'll find it clearly marked 
between C3 and C4. Fitting the ‘standard’ 
components like resistors, capacitors, diodes 
and transistors should not require further 
explanation here. Regarding the terminal 
blocks and the 9-way sub-D connectors, you 
first mount them on the PCB to make sure 
they do not get in each other’s way. Next, 
you solder the pins. 

Before inserting the ready-programmed 
microcontroller (item 000089-41) in its socket 
(we recommend one with turned pins), you 
should first check the presence of the circuit 
supply voltage at a number of relevant points 
in he circuit. When no apparent faults are 
found, switch off the supply and only then 
insert the controller into its socket (observing 
the orientation of the IC). 

Those of you having an Atmel AT90 pro- 
grammer available may want to burn their 
own chip for the project. To be able to do so 
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Figure 4. The electronics in the e-Key reader is really down to a single microcontroller type AT 90S | 200. 
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you require the project source code 
file which is available either on disk 
number 000089-11 supplied through 
our Readers Services, or from the Free 
Downloads pages on our website at 
http://www.elektor-electronics.co.uk. 
The source code file may be assem- 
bled into executable code using 
Atmel’s program AVRASM.EXE 
which may be downloaded free of 
charge from the Atmel website. 


The program 


When the circuit is powered up, the 
following elements are initialised: 
ports, timer and watchdog. At the 
same time, an automatic CRC is per- 
formed across the EEPROM memory. 
If the verification process is correctly 
finished, LED D2 lights and the cir- 
cuit waits for an interrupt request to 
arrive. Once that arrives, the pro- 
gram finds out the origin of the inter- 
rupt (i.e., key read or RS232 data 
arriving). Each of these is discussed 


briefly below. 

Key Read Interrupt 

First, the command code is transmit- 
ted. Next, the bytes supplied by the 
key are read into the system and the 
checksum is verified. The result 
should be zero. If not, the # charac- 
ter is transmitted over the serial line 
and the normal sequence of events 
is abandoned. If the CRC reads zero 
as it should, all bytes read from the 
key are transmitted on the serial line. 
Next, the code is looked up in the 
EEPROM memory. If the code is not 
found, the sequence is abandoned 
again and the system returns to 
waiting for an interrupt. If the code 
read from the key is present, the out- 
put relays are actuated depending 
on EEPROM resident values of the 
bytes associated with the key code. 
When the relay actions are finished, 
the circuit returns to waiting for an 
interrupt. Note that keys can not be 
recognized while any of the relays is 
actuated. 
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COMPONENTS LIST 


Resistors: 

RI = 5kQ6 
R2,R4,R6,R8 = 10kQ 
R3,R7,R9,RIO = IkQ 
R5 = 100kQ 


Capacitors: 

Cl = 100QuF 25V radial 
C2,C3,C7 = 100nF 
C4 = |0uF IOV radial 
C5,C6 = 22pF 


Semiconductors: 
DI = IN4001 
D2,D4,D5 = LED 
D3,D6,D7 = IN4148 


TI = BC547 
T2,T3 = BC557 
IC] = 7805 


IC2 = AT90S1200 (programmed, 
order code 000089-41) 


Miscellaneous: 

KI = 2-way PCB terminal block, 
raster 5mm) 

XI = 4MHz quartz crystal 

REI,RE2 = PCB mount relay, 6 V, 
| changeover contact, e.g., 
V23057-B0001-A1I01 (Siemens) 

K3 = 9-way sub-D socket 
(female), PCB mount 

K4,K5 = 3-way PCB terminal 
block, raster 7.5mm) 

Keys = Serial Number iButton™ 
DS1990A (Dallas Semiconductor, 
RS Components, 

Farnell # 790-461) 

Optional: key support DS9093A 

Contact Reader for iButton™ 
DS9092 (RS Components, 
Farnell # 790-473) 

PCB, order code 000089-1 (see 
Readers Services page) 

Optional: project source code files 
on disk, order code 000089-1 I. 


RS232 Interrupt 
When a character is received from 
the PC or terminal, it is immediately 
scrutinised by the command proces- 
sor. If the character is valid, the rele- 
vant command action is launched. 
Invalid characters cause the system 
to return an asterisk (*) to the PC or 
terminal. 

(000089-1) 
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Figure 5. Copper track layout and component mounting plan of the PCB designed for the e- 
Key project (board available ready-made). 





On the Internet 


If you want to know more about the 
DS1990A, the iButton chip or Atmel’s free- 
ware assembler mentioned in this article, 
pay a visit to these websites: 


http://www.ibutton.com 
http://www.dalsemi.com 
http://www.atmel.com 
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